#  知识点:函数相关

#
# Python 函数
# 定义一个函数，以下是简单的规则：
# 1.函数代码块以 def 关键词开头，后接函数标识符名称和圆括号()。
# 2.任何传入参数和自变量必须放在圆括号中间。圆括号之间可以用于定义参数。
# 3.函数的第一行语句可以选择性地使用文档字符串—用于存放函数说明。
# 4.函数内容以冒号起始，并且缩进。
# 5.return [表达式] 结束函数，选择性地返回一个值给调用方。不带表达式的return相当于返回 None。

# 命名规范 :函数名一律小写，如有多个单词，用下划线隔开

# 语法格式:
# def functionname( parameters ):
#    "函数_文档字符串"
#    function_suite
#    return [expression]


def test2method(params):
    """this is description of method"""
    print(params)
    return


test2method(["bench", "ricky"])


# python 中一切都是对象，严格意义我们不能说值传递还是引用传递，我们应该说传不可变对象和传可变对象。
# 在 python 中，类型属于对象，变量是没有类型的：即参数么牛类型
# 这就引出了,Python 中的可更改(mutable)与不可更改(immutable)对象
# 在 python 中，strings, tuples, 和 numbers 是不可更改的对象，而 list,dict 等则是可以修改的对象。

# 不可变类型：变量赋值 a=5 后再赋值 a=10，这里实际是新生成一个 int 值对象 10，再让 a 指向它，而 5 被丢弃，不是改变a的值，相当于新生成了a。
# 可变类型：变量赋值 la=[1,2,3,4] 后再赋值 la[2]=5 则是将 list la 的第三个元素值更改，本身la没有动，只是其内部的一部分值被修改了。

# python 函数的参数传递：
# 不可变类型：类似 c++ 的值传递，如 整数、字符串、元组。如fun（a），传递的只是a的值，没有影响a对象本身。比如在 fun（a）内部修改 a 的值，只是修改另一个复制的对象，不会影响 a 本身。
# 可变类型：类似 c++ 的引用传递，如 列表，字典。如 fun（la），则是将 la 真正的传过去，修改后fun外部的la也会受影响
# 也就是说在 Python 中 不可变对象 作为参数传递,传递的是值(函数内部修改对象,不会影响对象的值), 可变对象作为参数传递,传递的是引用(函数内部修改会影响对象的值).

# 传不可变对象
def int2change(params):
    """改变参数的值"""
    params = 10
    return


b = 2
int2change(b)
print(b)  # 结果是 2


# 传可变对象
def list2change(little1list):
    """修改传入的列表"""
    little1list.append([1, 2, 3, 4])
    print("函数内取值: ", little1list)
    return


temp1list = [10, 20, 30]
list2change(temp1list)
print("函数外取值: ", temp1list)


# 参数
# 包含:
# 必备参数
# 必备参数须以正确的顺序传入函数。调用时的数量必须和声明时的一样。
# def person1info(age, name, height):
#     """ 打印 person 信息"""
#     print()

# 关键字参数
# 使用关键字参数允许函数调用时参数的顺序与声明时不一致，因为 Python 解释器能够用参数名匹配参数值。

def person1info(age, name, height):
    """ 打印 person 信息"""
    print("age = ", age)
    print("name = ", name)
    print("height = ", height)
    return


person1info(height=178, name="bench", age=12)


# 默认参数

def person2info(name, age=35):
    """默认参数的函数使用"""
    print("Name: ", name)
    print("Age ", age)
    return


person2info("tom", 22)
person2info("tom")


# 不定长参数
# 函数能处理比当初声明时更多的参数
def person3info(name, *params):
    """ 可变参数的函数使用"""
    print("name = ", name)
    for var in params:
        print("var", var)


person3info("jim", 1)
person3info("grape", 1, "北京", "葡萄", "2018")


# 匿名函数
# python 使用 lambda 来创建匿名函数。
# lambda的主体是一个表达式，而不是一个代码块。仅仅能在lambda表达式中封装有限的逻辑进去。
# lambda函数拥有自己的命名空间，且不能访问自有参数列表之外或全局命名空间里的参数。
# 虽然lambda函数看起来只能写一行，却不等同于C或C++的内联函数，后者的目的是调用小函数时不占用栈内存从而增加运行效率。
# TODO

# return 语句的使用

def sum2number(arg1, arg2):
    """ 获取两个参数的和,然后返回"""
    total = arg1 + arg2
    print("函数内 : ", total)
    return total


result = sum2number(19, 23)

print("求和结果:", result)

# 变量作用域
# Python 变量分为 全局变量和局部变量
# 定义在函数内部的变量拥有一个局部作用域，定义在函数外的拥有全局作用域。

total = 0  # 这是一个全局变量


def sum2number2(arg1, arg2):
    """返回2个参数的和"""
    total = arg1 + arg2  # total在这里是局部变量.
    print("函数内是局部变量 : ", total)
    return total;


sum2number2(10, 20);
print("函数外是全局变量 : ", total)
